home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / tjlot14.zip / TJLOTTO.DOC < prev   
Text File  |  1992-05-25  |  16KB  |  398 lines
  1.  
  2.  
  3.                        ============================
  4.                            The T&J LOTTO Door!
  5.                        ============================
  6.                            (c)1992 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  11.  
  12.                        VERSION 1.40     05/25/92
  13.  
  14.                                    By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30. LATEST VERSION:
  31. ===============
  32.  
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35. LEGALITIES:
  36. ===========
  37.  
  38. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  39. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  40. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  41. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  42. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  43. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  44.  
  45. DISTRIBUTION:
  46. =============
  47.  
  48. You may make this file available for downloading from your BBS or you may
  49. upload it to any BBS of your choice, provided that you do not make any
  50. changes to the contents of the archive (ZIP file). The archive and its
  51. individual contents may not be used by any service that charges any money
  52. whatsoever, without the written permission of the author.
  53.  
  54. PROGRAM DESCRIPTION:
  55. ====================
  56.  
  57. The T&J LOTTO Door allows your users to select numbers on a type of
  58. lottery ticket. The number range is SysOp configurable along with the
  59. number or tickets a person may enter per day. As the SysOp, you can pick
  60. the prizes awarded for correctly getting 4, 5 or 6 digits correct.
  61.  
  62. The user gets a chance to pick 10 numbers per lottery ticket from the
  63. number range you specify. Running TJLOT14 with the command line LOTTO
  64. (maintenance program) must be run each night. The LOTTO command line
  65. picks the winning numbers (it selects 6 numbers from the range you specify)
  66. and then reads each of the users lottery tickets and checks for winners.
  67. It will LOG the PRIZE WINNING tickets to a special SYSOP.LOG file for
  68. your records. It will also keep a listing of the last 7 days of winning
  69. tickets for the users to check.
  70.  
  71. The door also maintains a statitics file which will keep track of how many
  72. times the door was played, how many tickets (total) have been purchased,
  73. and the total winning tickets (tickets matching 4, 5, or 6 digits).
  74.  
  75. The user can check all winning lottery tickets from the previous night
  76. and a summation of all PRIZE WINNING tickets for the last week.
  77.  
  78. The LOTTO command line maintenance program will create a color and ASCII
  79. bulletin either stating that NO winning tickets were picked or that there
  80. were winning tickets picked.
  81.  
  82. NOTE:
  83. =====
  84.  
  85. The LOTTO.KEY file that is distributed with this door does NOT expire!
  86. This is simply here so the door has a KEY to read. When you register,
  87. you will receive a new LOTTO.KEY file which will unlock the full version
  88. of the door. I don't know any other way to do this, and I refuse to use
  89. any type of expiration date routines.
  90.  
  91. The user is limited to just ONE ticket until registered.
  92.  
  93.  
  94. FEATURES:
  95. =========
  96.            --- Desqview Aware.
  97.            --- COM1-4 support and non-standard IRQ's.
  98.            --- Colorful ANSI screens.
  99.            --- Chat function.
  100.            --- NO BRUN module needed for play.
  101.            --- BETA tested on five different boards.
  102.            --- Will return to BBS on dropped carrier.
  103.            --- Will TIMEOUT a player after 5 minutes of no activity.
  104.            --- Use of HOT KEYS while in the door.
  105.            --- Handy statistics presented to user on door usage.
  106.            --- Support BBS available.
  107.            --- Easily RESET the entire program.
  108.  
  109.  
  110.  
  111. CONFIGURATION:
  112. =============
  113.  
  114. Example configuration file for PCBOARD.SYS
  115. ------------------------------------------
  116.  
  117. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  118. T&J Software        <=-  (Change this to your BBS name)
  119. Tom                 <=-  (The Sysop's first name)
  120. Wildoner            <=-  (The Sysop's last name)
  121.  
  122. Example configuration file for USERS.SYS
  123. ----------------------------------------
  124.  
  125. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  126. T&J Software        <=-  (Change this to your BBS name)
  127. Tom                 <=-  (The Sysop's first name)
  128. Wildoner            <=-  (The Sysop's last name)
  129.  
  130. Example configuration file for DOOR.SYS
  131. ---------------------------------------
  132.  
  133. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  134. T&J Software        <=-  (Change this to your BBS name)
  135. Tom                 <=-  (The Sysop's first name)
  136. Wildoner            <=-  (The Sysop's last name)
  137.  
  138. Example configuration file for USERINFO.DAT
  139. -------------------------------------------
  140.  
  141. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  142. T&J Software        <=-  (Change this to your BBS name)
  143. Tom                 <=-  (The Sysop's first name)
  144. Wildoner            <=-  (The Sysop's last name)
  145. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  146.  
  147. Example configuration file for CALLINFO.BBS
  148. -------------------------------------------
  149.  
  150. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  151. T&J Software        <=-  (Change this to your BBS name)
  152. Tom                 <=-  (The Sysop's first name)
  153. Wildoner            <=-  (The Sysop's last name)
  154.  
  155. Example configuration file for DORINFOx.DEF
  156. -------------------------------------------
  157.  
  158. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  159.                           where 'x' is the BBS Node number.
  160. T&J Software        <=-  (Change this to your BBS name)
  161. Tom                 <=-  (The Sysop's first name)
  162. Wildoner            <=-  (The Sysop's last name)
  163.  
  164. Example configuration file for SFDOORS.DAT
  165. ------------------------------------------
  166.  
  167. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  168. T&J Software        <=-  (Change this to your BBS name)
  169. Tom                 <=-  (The Sysop's first name)
  170. Wildoner            <=-  (The Sysop's last name)
  171.  
  172. Example configuration file for CHAIN.TXT
  173. ----------------------------------------
  174.  
  175. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  176. T&J Software        <=-  (Change this to your BBS name)
  177. Tom                 <=-  (The Sysop's first name)
  178. Wildoner            <=-  (The Sysop's last name)
  179.  
  180. Example configuration file for GTUSER.BBS
  181. -----------------------------------------
  182.  
  183. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  184. T&J Software        <=-  (Change this to your BBS name)
  185. Tom                 <=-  (The Sysop's first name)
  186. Wildoner            <=-  (The Sysop's last name)
  187. 1                   <=-  (COM port number - defaults to 1)
  188. 1                   <=-  (Node number - defaults to 1)
  189.  
  190. Example Batch File
  191. ==================
  192.  
  193. A sample batch file is included and is similer to the following:
  194.    ECHO OFF
  195.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  196.    LEMON30 LEMON.CFG        <=- Execute the door program and pass the
  197.                                 configuration filename to the program.
  198.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  199.    BOARD                    <=- Restart BBS.
  200.  
  201. This Door is multi-node  compatible so you may run more than 1 node from
  202. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  203. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  204. variables, (q.v.)
  205.  
  206. Environment Variables
  207. =====================
  208.  
  209. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  210. variables. Non-PCBoard systems may also use these variables by including
  211. the following in either your BBS batch or AUTOEXEC.BAT
  212.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  213.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  214. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  215. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  216. .CFG file for multi-node operation!
  217.  
  218. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  219. command line.  For example:
  220.  
  221.      LEMON30 LEMON.CFG /5
  222. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  223.      LEMON30 LEMON.CFG /%IRQ%
  224.  
  225. This tells the program to use IRQ 5 instead of the standard IRQ.
  226.  
  227.  
  228. Sysop Keys
  229. ==========
  230.  
  231. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  232.          written to DOOR.SYS and USERS.SYS
  233. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  234.          and/or written to DOOR.SYS and USERS.SYS
  235. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  236. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  237.          and/or written to DOOR.SYS and USERS.SYS
  238. F8    -  Returns the caller involuntarily to the BBS.
  239. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  240.          and/or written to DOOR.SYS and USERS.SYS
  241. F10   -  Activates SysOp CHAT mode within the DOOR.
  242. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  243. UP    -  Give the caller extra time while in the DOOR.  
  244. DN    -  Subtract time from the caller while in the DOOR. 
  245. HOME  -  HELP key for Status Line options.
  246. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  247. ALT-X -  PCBoard will exit after current caller logs off. Value is
  248.          passed to PCBoard. Not available on non-PCBoard systems.
  249.  
  250.  
  251.  
  252. Your SYSOP.CFG file should contain ALL the items listed below. You can use
  253. your text editor to edit the provided file.
  254.  
  255. First prize is a registered GAME PACK! A $50 value if you have a
  256. winning 6 number LOTTO ticket!
  257. If you get five digits, you'll get a free registered door of your
  258. choice! Pick the one you like best!
  259. And, if you get 4 digits, get a free registered copy of the OneRun
  260. program -- a $5 value!
  261. c:\wc30\bull\bull1.scr
  262. c:\wc30\bull\bull1.bbs
  263. 60
  264. 6
  265.  
  266. LINE 1&2: The prize that will be awarded for getting all 6 numbers
  267.           correct. If you only use one line, leave line 2 blank! Try
  268.           to limit each line to 70 characters. This text will be
  269.           centered in the door display, so don't worry about centering.
  270. LINE 3&4: The prize that will be awarded for getting 5 numbers correct.
  271.           follow the same guidance as above.
  272. LINE 5&6: The prize that will be awarded for getting 4 numbers correct.
  273.           follow the same guidance as above.
  274. LINE   7: PATH to your color bulletin.
  275. LINE   8: PATH to your ASCII bulletin.
  276. LINE   9: The range for your numbers (i.e. from 1 to ??). Try keeping
  277.           this number between 40 and 80 in intervals of 10 (40, 50, 60
  278.           70, or 80). What are the chances of winning you ask? See the
  279.           section titled CHANCES?!? listed below.
  280. LINE  10: How many tickets a person can enter in one day.
  281.  
  282. The file MUST have all 10 lines!
  283.  
  284.  
  285. To run in LOCAL mode simply run the LOCAL.BAT file or run as TJLOT14 LOCAL
  286. either way will work.
  287.  
  288.  
  289. CHANCES?!?
  290. ==========
  291.  
  292. How often do you want your users to win? I randomly generated 25,000 tickets
  293. for each possible range of number (i.e. 1 to 40, 1 to 50, 1 to 60, 1 to 70,
  294. and 1 to 80). The data will show how many tickets had 0 numbers picked, 1
  295. number picked, etc.... Here are the results I obtained:
  296.  
  297. Number Range from 1 to 30, tickets generated: 25000
  298. 0: 1635  1: 6466  2: 9183  3: 5831  4: 1681  5: 199  6: 6
  299.  
  300. Number Range from 1 to 40, tickets generated: 25000
  301. 0: 3775  1: 9270  2: 8169  3: 3127  4: 615  5: 44  6: 1
  302.  
  303. Number Range from 1 to 50, tickets generated: 25000
  304. 0: 6093  1: 10228  2: 6516  3: 1880  4: 266  5: 18  6: 0
  305.  
  306. Number Range from 1 to 60, tickets generated: 25000
  307. 0: 7807  1: 10694  2: 5197  3: 1172  4: 123  5: 8  6: 0
  308.  
  309. Number Range from 1 to 70, tickets generated: 25000
  310. 0: 9554  1: 10374  2: 4215  3: 779  4: 78  5: 1  6: 0
  311.  
  312. Number Range from 1 to 80, tickets generated: 25000
  313. 0: 10953  1: 10090  2: 3384  3: 538  4: 36  5: 0  6: 0
  314.  
  315. As you can see, the higher the number, the fewer 4, 5, and 6 digit
  316. winners are. This doesn't mean that a user on his first attempt will
  317. not hit the BIG ONE (6 digits) on his first attempt at picking numbers
  318. from the range of 1 to 80!
  319.  
  320. If you have a very nice prize setup for hitting 6 digits, then use a
  321. higher number!
  322.  
  323. THE SPECIAL.USR FILE:
  324. ====================
  325.  
  326. The SPECIAL.USR file is just what is implied. It's there for special
  327. users of your system. Simply enter their name followed by a comma and then
  328. enter how many tickets they can play per day! See the example SPECIAL.USR
  329. file supplied with the door.
  330.  
  331. The number of tickets listed after their name will over-ride the default
  332. number of tickets you have listed in your SYSOP.CFG file. One idea
  333. you can use is to make the prize for getting 4 digits correct is increasing
  334. the number of tickets that user can play per day! If they hit 4 digits, add
  335. there name to the SPECIAL.USR file and increase the number of tickets they
  336. can play!
  337.  
  338. RESETTING THE DOOR:
  339. ==================
  340.  
  341. To reset the door from scratch simply run TJLOT14 with the command line
  342. RESET.    --->  TJLOT14 RESET
  343.  
  344. MAINTENANCE!:
  345. ============
  346.  
  347. You must run TJLOT14 with the LOTTO command line as part of your nightly
  348. maintenance work for the door to operate properly! The maintenance routines
  349. for BBS's vary, so it's up to you to determine how to run this program as
  350. part of your maintenance.
  351.  
  352. Run it like this ---->    TJLOT14 LOTTO
  353.  
  354. FUTURE VERSIONS:
  355. ================
  356.  
  357. --->> Let me know what you would like to see!
  358.  
  359.  
  360. VERSION HISTORY:
  361. ===============
  362.  
  363. Version 1.00 ......... First release. 03/28/92
  364. Version 1.01 ......... Modified the computer generated ticket routines,
  365.                        no major problem but it needed to be fixed. 4-6-92
  366. Version 1.10 ......... Modified the opening screen routines -- some users
  367.                        seemed to think the startup was too long. You can
  368.                        now simply view the previous night's winners, last
  369.                        seven days of winners, and the prize from the main
  370.                        menu.  4-14-92
  371. Version 1.20 ......... Updated the code with the latest door routines.
  372.                        Fixed a small bug that would sometimes give a
  373.                        serious error (board lockup).  4-22-92
  374. Version 1.30 ......... Updated with new door routines, prizes will now
  375.                        show up even if the door isn't registered.
  376.                        05-17-92
  377. Version 1.40 ......... The LOTTO.EXE and the RESET.EXE programs were placed
  378.                        inside the main code (saved A LOT of space). Also,
  379.                        upgraded the door to the newest door routines.
  380.                        05-25-92
  381.  
  382. UPGRADING:
  383. =========
  384.  
  385. If you are upgrading from any version prior to v1.4 I would suggest
  386. reinstalling the door completely. Please note the change in the nightly
  387. maintenance routines! The LOTTO.EXE file is now history!
  388.  
  389.  
  390. REGISTERING:
  391. ============
  392.  
  393. That's all there is to it! If you have any problems or questions
  394. please feel free to call the T&J BBS at (717)325-9481 and join the
  395. T&J Software Conference.
  396.  
  397. See the enclosed registration form for ordering!  (REGISTER.TXT)
  398.